.TH IMAGEPLT 1 "19 December 2002" "plt 2.3" "WFDB Applications Guide"
.SH NAME
imageplt \- plot a greyscale image
.SH SYNOPSIS
\fBimageplt -d\fR \fInrows\fR \fIncols\fR [ \fIoptions ...\fR ] [ \fIfile\fR ]
.SH DESCRIPTION
.PP
\fBimageplt\fR provides a simple way to plot a greyscale image using
\fBplt\fR(1).  The required arguments, \fInrows\fR and \fIncols\fR,
specify the numbers of rows and columns in the image.  The input \fIfile\fR
(or the standard input, if no input file is specified) contains only the
grey levels for each pixel (0 = white, 1 = black).  Each entry is an
ASCII-coded decimal floating point number, separated from adjacent entries
by whitespace (one or more spaces, tabs, or newlines).  The first \fInrows\fR
entries are the grey levels for column 0 of the image, botttom to top, and
each successive column from left to right of the image follows.  If \fInrows\fR
is small, it may be convenient to arrange the image file in columns and rows
corresponding to those of the image, but this is not necessary.  In no case
should the length of a line of input exceed 50000 bytes (defined as MAXLEN
in the source).
.PP
\fIOptions\fR include:
.TP
\fB-n\fR
Generate a negative image (1 = white, 0 = black).
.TP
\fB-x\fR \fIxmin\fR \fIxmax\fR
Specify the range of the x-coordinates (default: \fIxmin\fR=0,
\fIxmax\fR=\fInrows\fR-1).
.TP
\fB-y\fR \fIymin\fR \fIymax\fR
Specify the range of the y-coordinates (default: \fIymin\fR=0,
\fIymax\fR=\fIncols\fR-1).
.PP
The output of \fIimageplt\fR is text in three columns, to be plotted using
the \fB-pc\fR option of \fBplt\fR, as in:
.IP
imageplt -d 10 10 foo | plt 0 1 2 -pc
.SH SEE ALSO
.PP
\fBplt\fR(1), \fBpltf\fR(1)
.SH AVAILABILITY
\fBimageplt\fR is available as part of the \fBplt\fR package in
PhysioToolkit (see \fBSOURCES\fR below) under the GPL.
.SH AUTHOR
George B. Moody (\fBgeorge@mit.edu\fR)
.SH SOURCE
\fBhttp://www.physionet.org/physiotools/plt/plt/misc/imageplt.c\fR
